Home

FloatingX Wiki

FloatingX 是一个灵活且强大的 Android 悬浮窗解决方案：App 级全局浮窗、系统级浮窗、局部浮窗、Compose 内容，按需依赖。 3.0 是一次彻底重写，不兼容 2.x 的 API。

页面	内容
快速开始	模块与依赖、版本要求、四种 host 的最小示例
App 级全局浮窗	App 级全局浮窗：跟随 Activity、黑白名单 / filter、挂载点、theme、Java Builder
系统级浮窗	系统级浮窗：权限三策略、降级 fallback、LayoutParams、键盘、返回键、Service
局部浮窗	局部浮窗：`ViewGroupHost` / `FragmentHost` / `fxScope {}`
Compose 浮窗	`compose {}` DSL、`FxComposeOwner`、`stateFlow()` / `positionFlow()`
配置项	能力一览与全部配置项：锚点 / 吸附 / 手势 / 动画 / modal / 持久化 / `update {}`
API 速查	`FxControl` / `FxListener` / `FloatingX` 注册表速查
常见问题	常见问题
从 2.x 迁移	2.x → 3.0 迁移指南
Issue 覆盖矩阵	issue 覆盖矩阵
架构设计	Host / Engine / Feature 三角色与扩展方式
Demo 说明	示例工程：能力页 / 回归页与运行方式

Page	Content
Getting Started	Modules & dependencies, requirements, minimal samples for the four hosts
App Host	App-level global window: follows the Activity, black/white list, attach target, theme, Java builder
System Host	System window: permission strategies, fallback, LayoutParams, keyboard, back key, Service
Scope Host	Local windows: `ViewGroupHost` / `FragmentHost` / `fxScope {}`
Compose	The `compose {}` DSL, `FxComposeOwner`, `stateFlow()` / `positionFlow()`
Configuration	Capabilities and every config option: anchor / adsorption / gestures / animation / modal / persistence / `update {}`
API Reference	`FxControl` / `FxListener` / the `FloatingX` registry
FAQ	Frequently asked questions
Migration from 2.x	2.x → 3.0 migration guide
Issue Coverage	Issue coverage matrix
Architecture	Host / Engine / Feature and how to extend them
Demo	Sample app: capability pages, regression pages, how to run

文档

English